home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / tt / tt_disk.005 / prflags / read.me < prev   
Encoding:
Text File  |  1996-09-18  |  4.4 KB  |  86 lines
  1. PRGFLAGS - a utility to set flags in program headers
  2. Copyright © 1991, Atari Corporation
  3. All Rights Reserved
  4.  
  5. Starting with Rainbow TOS, some bits at the start of each program file
  6. gained a special meaning.  One of the Rainbow TOS utilities, MAKEFAST,
  7. allowed you to set the "Fastload" bit in the program header, which tells
  8. TOS not to clear all of RAM before running a program.  On machines with
  9. a lot of memory, this can speed program load time significantly.
  10.  
  11. Now, on the TT, there are two more bits that can make your programs go
  12. faster.  PRGFLAGS is a GEM and/or command-line utility to allow you to
  13. modify and view these bits in a program header.  Because some programs
  14. use RAM in ways that TT RAM can not be used, PRGFLAGS lets you set up
  15. programs so that they are fast, compatible, or both.  The new "Run in TT
  16. RAM" flags lets you tell TOS whether it should try to load the program
  17. into the faster TT RAM or restrict it to ST RAM only.  The "Use TT RAM"
  18. flag tells TOS that when a program asks for more memory, TOS should try
  19. to give it TT RAM if possible.
  20.  
  21.  
  22. You can use PRGFLAGS one of two ways, from the desktop, in a dialog,
  23. clicking your way around, or on the command line, giving it arguments.
  24. The dialog looks much like a standard file selector, with a few added
  25. features.  To the left of the list of files are a set of buttons and a
  26. set of indicators which let you view and modify the program flags of
  27. the programs displayed.  To the right of the file window is the
  28. familiar stack of drive buttons.  One quirk of the PRGFLAGS drive
  29. buttons is that they will not let you select a drive that has no files
  30. or directories on it.
  31.  
  32. In the name bar of the file window is a pop-up menu that lets you
  33. quickly navigate directories.  You can move around directories in
  34. PRGFLAGS the same way you do in the file selector, except that there is
  35. no text line for you to enter a specific directory name.  If you pop up
  36. the directory menu, you can quickly return to any parent directory of
  37. the one being displayed simply by clicking on it.
  38.  
  39. PRGFLAGS displays a list of all executable files that it can find in a
  40. specific directory.  This includes both programs and desk accessories. 
  41. Immediately to the left of the file list is a display list which shows
  42. the current state of the programs' "Fastload," "Run in TT RAM" and "Use
  43. TT RAM" flags.  In the far left is a set of buttons that allows you to
  44. set or clear the flags.
  45.  
  46. Underneath the file window is a row of buttons labeled "All."  If you
  47. set the flag values using any of these buttons, all files in the
  48. currently selected directory will be modified, regardless of whether
  49. they are visible in the file window or not.  You can verify this for
  50. yourself by selecting one of those buttons and scrolling up and down in
  51. a big list of files.  You will see that all the files in the directory
  52. are set to the state of the "All" button you clicked.
  53.  
  54. Read only files are indicated in the file window with a "delta"
  55. character, just like on the TT/MegaSTE desktop in text mode.  You CAN
  56. modify the program flags of read only files using PRGFLAGS.
  57.  
  58. If you have a TT or Mega STE, you can use PRGFLAGS by dropping a file
  59. onto it on the desktop or in a window.  When the dialog comes up, it
  60. will display the directory of the file you dropped onto PRGFLAGS, and 
  61. the file name will flash so you can quickly find it in the file window.
  62.  
  63. One more point: if you set some buttons to modify files in a directory
  64. and you try to change directories or quit PRGFLAGS, it will ask you
  65. whether you want to update the flags or discard your changes.
  66.  
  67. People who like to use command lines can use PRGFLAGS from the command
  68. line or from a makefile.  For information on command line options run
  69. prgflags with the arguments "h h" from your shell.  PRGFLAGS supports
  70. the GEMDOS extended arguments standard, so you can feed it as many
  71. filenames as you like.  Even in command mode, PRGFLAGS will not let you
  72. modify a non-executable file.
  73.  
  74. A tip for command line users:
  75.   "prgflags 0 0 <program>"
  76. will display the current program flags for <program>.
  77.  
  78. You'll find the answers to any questions you may have about PRGFLAGS in
  79. the ST RoundTable on GEnie.  Leave a message in Category 14 of the ST
  80. Bulletin Board (M475;1 to get there, or use ST Aladdin!) and you'll find
  81. lots of people there, including the author, willing to help you.
  82.  
  83.   Ken Badertscher
  84.   Atari Corp. System Software Engine
  85.   February 15, 1991
  86.